home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / prog_bas / vbit140.zip / README.TXT < prev    next >
Text File  |  1996-01-18  |  19KB  |  418 lines
  1. _____________________________________________________________________________
  2.  
  3. VBIT: Visual Basic Invisible Tools 1.40
  4. _____________________________________________________________________________
  5.  
  6. > WHAT IS VBIT?
  7.  
  8.   VBIT is a library of useful and timesaving routines which
  9.   makes life easier for any Visual Basic programmer.
  10.  
  11.   Contents of VBIT:
  12.  
  13.   + Dynamic one/two-dimensional tables (arrays) consisting of dynamic text-
  14.     strings enables you to manipulate significantly bigger amounts of data
  15.     than Visual Basic alone can handle. Smart sorting, seek, read files,
  16.     write to file, linking to spreadsheets etc. is also included.
  17.  
  18.   + Simple, but very powerful routines for string-manipulation
  19.  
  20.   + Simplified reading/writing of INI-files compared to API-calls
  21.  
  22.   + Routines for reading system-information, i.e. available
  23.     disk space, memory, screen resolution etc.
  24.  
  25.   + Encryption algorithms (with no "back-door") enable you to easily
  26.     protect your data against unwanted intruders.
  27.  
  28.   + Elegant copy protection of software and applications. This software
  29.     (VBIT) uses the same copy protection itself, so try it out and evaluate.
  30.  
  31.   VBIT is an InfoTech AS product. This package is intended for
  32.   Visual Basic, but the same software will soon be available for C++.
  33.  
  34.   Please see the enclosed files VBIT.WRI, VBITABLE.WRI, VBITFILE.WRI and
  35.   VBITVTSS.WRI (standard Windows 3.1 Write format - can also be read
  36.   from MS Word) for a detailed  description of routines and functionality.
  37.  
  38.   This software is distributed as "shareware" (see below for details), and
  39.   we have and will continue to relaease regular updates. If this file is
  40.   more than a couple of months old (see file-date), it is likely that there
  41.   is a newer release in circulation, so call your favorite BBS to get the
  42.   most recent version.
  43.  
  44.   You can visit our WWW-pages to check:      http://www.prodat/infotech/
  45.   You can visit our WWW-pages to check:      http://www.traders.no/
  46.  
  47.   The latest release of VBIT will also always be avaliable at Trader's
  48.   Mascot BBS, running Excalibur BBS (+47/7012-9014 or +47/7012-5102).
  49.  
  50.   Any comments and/or suggestions are welcome, and can be sent/mailed to:
  51.  
  52.   InfoTech AS                                       infotech@telepost.no
  53.   Strandgt. 207                                     """"""""""""""""""""
  54.   N-5004 BERGEN, Norway
  55.  
  56. or
  57.  
  58.   Trader's Mascot AS                                bjonor01@mimer.no
  59.   Postboks 3098 Sentrum                             ^^^^^^^^^^^^^^^^^
  60.   N-6001 AALESUND, Norway
  61.  
  62. _____________________________________________________________________________
  63.  
  64. NB: This file contains special characters based on WINDOWS character set.
  65.     If you use a DOS program to read this, special characters will not
  66.     display correctly, and the examples in this document will not be
  67.     readable.
  68. _____________________________________________________________________________
  69.  
  70. > TABLES
  71.  
  72.   A table is a matrix of text-strings, which can be thought of as an
  73.   invisible spreadsheet in RAM. The tables can be dimensioned according
  74.   to your needs, and dynamic changes can be made at any time. You can
  75.   read tables directly from a number of file formats, and the tables are
  76.   automatically dimensioned according to the file-contents. The same
  77.   applies for writing tables to different file formats.
  78.  
  79.   Reading and writing data from/to tables, seek and sort are very fast
  80.   operations.
  81.  
  82.   The sorting routine for tables has some unique features. This sorting
  83.   routine sorts numbers embedded in strings in a sensible fashion.
  84.  
  85.   For example, if you are sorting strings of the format "Number x of y"
  86.   where 'x' and 'y' are numbers, then:
  87.  
  88.                 Ordinary sorting  
  89.                 ----------------
  90.                 Number 1 of 100   
  91.                 Number 10 of 100  
  92.                 Number 100 of 100 
  93.                 Number 2 of 100   
  94.                 Number 20 of 100  
  95.                 Number 20 of 50   
  96.  
  97.                 VBIT SmartSort
  98.                 --------------
  99.                 Number 1 of 100
  100.                 Number 2 of 100
  101.                 Number 10 of 100
  102.                 Number 20 of 50
  103.                 Number 20 of 100
  104.                 Number 100 of 100
  105.  
  106.   Sorting of special characters is greatly improved compared to most
  107.   competing sort-routines. Characters like /E/╔/e/Θ/Φ/δ/Ω/ are treated as
  108.   variations on the same letter, i.e. the difference is only significant
  109.   for the sort-order when the remaining characters are identical.
  110.  
  111.                 VBIT SmartSort
  112.                 --------------
  113.   Line 1:       Sequence 10
  114.   Line 2:       SequΦnce 20
  115.   Line 3:       Sequence 30
  116.   Line 4:       SequΦnce 30
  117.   Line 5:       SequΦnce 40
  118.   Line 6:       SequencΦ 50
  119.   Line 7:       SequencΘ 60
  120.  
  121.   Between lines 1 and 2 the difference between "e" and "Φ" has no
  122.   significance since the remaining characters are different. The same
  123.   applies for lines 2 and 3. The only difference between lines 3 and 4
  124.   is "e"/"Φ", and consequently the record containing "e" will be sorted in
  125.   front of the other, since "e" is defined before "Φ" in this package.
  126.  
  127.   You may say that this is trivial, but may change your mind when you
  128.   see how most other programs handle sorting of the same records:
  129.  
  130.                 Ordinary sorting  
  131.                 ----------------
  132.   Line 1:       Sequence 10
  133.   Line 2:       Sequence 30
  134.   Line 3:       SequencΘ 60
  135.   Line 4:       SequencΦ 50
  136.   Line 5:       SequΦnce 20
  137.   Line 6:       SequΦnce 30
  138.   Line 7:       SequΦnce 40
  139.  
  140.   VBIT contains several different seek-routines for finding data in a
  141.   table, i.e. exact match, wildcards and binary-search (data in a sorted
  142.   table).
  143. _____________________________________________________________________________
  144.  
  145. > STRING-HANDLING / INI-FILES
  146.  
  147.   Most Visual Basic programmers sooner or later face the "problem" that
  148.   most program-utilities for returning strings, anticipate that the calling
  149.   program has allocated space for the returned string. To illustrate this
  150.   we will show you the difference between reading INI-files traditionally
  151.   (via API) and using VBIT:
  152.  
  153.   ' Read name of starting program for Windows from SYSTEM.INI:
  154.  
  155.     Declare Function GetPrivateProfileString% Lib "Kernel" (ByVal pAppName$,
  156.                      ByVal pKeyName$, ByVal pDefault$,
  157.                      ByVal pReturnedString$, ByVal nSize%, ByVal pFileName$)
  158.  
  159.     txt$ = String$(80, " ") ' Reserve space for 80 chars
  160.     len% = GetPrivateProfileString("boot","shell","",txt$,80,"SYSTEM.INI")
  161.     StartProg$ = Left$(txt$, len%) ' Possible result: "progman.exe"
  162.  
  163.   ' Same as above using VBIT (VBIT.BAS is included in the project):
  164.  
  165.     StartProg$ = IniFileGetString("SYSTEM.INI", "boot", "shell")
  166.  
  167.   I think we have made our point, and showed beyond reasonable doubt which
  168.   method is the easiest to PROGRAM, MAINTAIN and last but not least to
  169.   UNDERSTAND!
  170.  
  171.   VBIT provides a number of powerful routines for string-manipulation
  172.   that Visual Basic "lacks": pick words from strings, swap parts of strings,
  173.   formatting, translation between DOS and Windows character sets and much
  174.   more. See VBIT.WRI for a complete and detailed documentation.
  175.  
  176. _____________________________________________________________________________
  177.  
  178. > SYSTEM INFORMATION
  179.  
  180.   Routines that gives easy access to system-information: screen resolution,
  181.   number of colors, free disk-space, available RAM, disk(ette)-unit status
  182.   etc. Details on environment variables and directory information can be
  183.   read directly into tables.
  184.  
  185. _____________________________________________________________________________
  186.  
  187. > ENCRYPTION
  188.  
  189.   If you want to protect data against unwanted intruders, you can achieve
  190.   this by using the VBIT encryption routines. These routines are not
  191.   based on any standard algorithm specified by "Big Brother", and has
  192.   therefore no "back door". There is no possibility whatsoever to recover
  193.   an encrypted string without the correct key - not even for those who
  194.   made the program.
  195.  
  196.   The routines are very simple in use; you specify the text-string to be
  197.   coded together with the "secret key" and the result is a completely
  198.   unreadable string. When decoding the same string, you specify the
  199.   unreadable string and its key, and the original string is returned.
  200.   Using wrong keys will not unlock any doors.
  201.  
  202.   Example:
  203.  
  204.           TextIn$  = "Private information..."
  205.           Secret$  = "Sesam$⌡zaM"
  206.           Crypt$   = Encrypt (TextIn$, Secret$)
  207.           TextOut$ = Decrypt (Crypt$,  Secret$)
  208.  
  209.   ' TextOut$ and TextIn$ will be identical, and
  210.   ' Crypt$ will contain an unreadable string.
  211. _____________________________________________________________________________
  212.  
  213. > COPY PROTECTION
  214.  
  215.   The program library VBIT.DLL is copy protected. If you have no valid
  216.   license, you will be made aware of this by an annoying pop-up window
  217.   reminding you to contact InfoTech AS and purchase a copy. Most of the
  218.   VBIT routines will for the time being function without the annoying reminder,
  219.   but when you use table-functions or the encryption routines, the testing
  220.   for a valid license is activated.
  221.  
  222.   The only way to get rid of the "license-alarm" is to purchase a license
  223.   code from InfoTech AS. The license-code consists of a 6-letter alphanumeric
  224.   string which is derived from the name of the licensee. The license-name and
  225.   corresponding code must be inserted into all programs using VBIT:
  226.  
  227.      status% = LisenseVBIT("User Name, Address", "CODE01")
  228.  
  229.   This code is inserted in Form Load in the applications startup form.
  230.  
  231.   All applications using VBIT must have a license for the name holding
  232.   Copyright for the application. INFOTECH.INI will contain a list of all
  233.   programs using VBIT. If the application is using a licensed version
  234.   of VBIT, the licensee name will appear as the copyright holder of the
  235.   application. This means that an application using a "borrowed" license
  236.   code will appear as copyrighted by the name connected to the violated
  237.   license. Somebody actively programming a call to LicenseVBIT using
  238.   somebody else's name and code, can not claim to have acted in good faith.
  239.  
  240.   A similar copy protection scheme is available for all applications
  241.   using VBIT, provided a valid license:
  242.  
  243.   The call      code$ = LicenseGetCode("User Name","SECRET_KEY")
  244.   will return a code for the given user name. This call is supposed
  245.   to be used in a program only available for the distributor of
  246.   the application.
  247.  
  248.   The following statement is put into the application:
  249.                 status% = LicenseProgram(UserName$, Code$, "SECRET_KEY")
  250.  
  251.   Depending on the result, status%, your application can determine whether
  252.   the username/code is valid for this program, and take appropriate actions.
  253.   Different applications can have different keys ("SECRET_KEY_PROG2").
  254.  
  255.   When LicenseProgram has been called with a valid code, the user name will
  256.   be inserted in INFOTECH.INI connected to the name of your application in
  257.   the group [License].
  258. _____________________________________________________________________________
  259.  
  260. > SHAREWARE: RULES FOR USE AND DISTRIBUTION
  261.  
  262.   VBIT is distributed as "shareware". This term must not be mixed up
  263.   with "Freeware" or "Public domain". "SHAREWARE" is a method for
  264.   distribution of software which is protected by COPYRIGHT like all other
  265.   commercial software.
  266.  
  267.   The "shareware" concept gives potential users the opportunity to evaluate
  268.   the software before they decide whether they want to pay for the right
  269.   to use it.
  270.  
  271.   It is perfectly legal to use this software for testing in a trial period.
  272.   A reasonable test period is estimated to be 30 days. Using the software
  273.   beyond a reasonable trial period, or including it in a commercial
  274.   program without a legal license, will be regarded as a violation of
  275.   our copyright.
  276.  
  277.   An important part of the "shareware" concept is that the user must have
  278.   a chance to test all parts of the software. If the software is only
  279.   partly working, or deliberately causes erroneous results, it should not
  280.   be called "shareware", but "crippleware". Some "shareware" software
  281.   is also called "nagware" because of the annoying pop-ups constantly
  282.   reminding the user about the lack of license. VBIT is using this
  283.   approach, but you can still test all parts of it.
  284.  
  285.  
  286.   VBIT can be distributed freely on the following conditions:
  287.  
  288.   - All files in this package must be included (see PACKING.LST).
  289.  
  290.   - The files must be unchanged.
  291.     Archive file name must include version number (VBIT120.ZIP -> ver 1.20).
  292.     The date and time of the files should not be changed.
  293.     Time must correspond to the version number.
  294.  
  295.   - No files can be added to the package, with one exception: The BBS
  296.     distributing this software may include a short text file with a
  297.     short presentation of the BBS.
  298.  
  299.   - It is not allowed to charge for the distribution of this software,
  300.     except for normal downloading fees (if any), without the express 
  301.     permission from InfoTech AS.
  302.  
  303.   We encourage you to give copies of this software to your friends and
  304.   colleagues, and to upload it to any BBS that you use. For sample
  305.   descriptions suitable for BBS file listings, please see FILE_ID.DIZ
  306.   and DESC.SDI.
  307.  
  308. _____________________________________________________________________________
  309.  
  310. > COPYRIGHT / LIABILITY / CONDITIONS FOR USE
  311.  
  312.  
  313.   !    VBIT  Copyright (C) 1996  InfoTech AS,  BERGEN, NORWAY               !
  314.   !    Distributed by: Trader's Mascot AS, Aalesund, Norway                 !
  315.   !    ________________________________________________________________     !
  316.   !    Use this software  only  if you accept the following conditions:     !
  317.   !    """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""     !
  318.   !    THE SOFTWARE  VBIT  AND  ACCOMPANYING  DOCUMENTATION IS PROVIDED     !
  319.   !    AS IS WITHOUT WARRANTY OF ANY KIND. ALL USE IS AT YOUR OWN RISK.     !
  320.   !    INFOTECH AS CAN NOT BE MADE LIABLE FOR ANY DAMAGES CAUSED BY USE     !
  321.   !    OF THIS SOFTWARE AND DOCUMENTATION. OWNER OF A LEGAL LICENSE FOR     !
  322.   !    VBIT  IS  COMMITTED  TO KEEP  THIS CODE  UNAVAILABLE FOR OTHERS.     !
  323.   !    DELIBERATE DISTRIBUTION OF  A LICENSE CODE  WILL  BE REGARDED AS     !
  324.   !    A SEVERE  VIOLATION OF THE LICENSE CONDITIONS AND A VIOLATION OF     !
  325.   !    INFOTECH'S COPYRIGHT, AND WILL BE PROSECUTED.                        !
  326. _____________________________________________________________________________
  327.  
  328. > LICENSE-CODES / PRICE
  329.  
  330.   Contact InfoTech AS or Trader's Mascot AS to get a license code.
  331.   Current prices are:
  332.  
  333.   In Norway:           NOK 495 incl. M.V.A.
  334.   All other countries: US $ 65
  335.  
  336.   A valid license code gives you the right to distribute VBIT.DLL
  337.   with your programs.
  338.  
  339. _____________________________________________________________________________
  340.  
  341. > ORDERING INFORMATION / PAYMENT:
  342.   Price in Norway : NOK 495,- incl. mva.  all other countries : $65
  343.  
  344.   Send to:   Trader's Mascot AS
  345.              Postboks 3098 Sentrum
  346.              N-6001 AALESUND, Norway
  347.  
  348.   ___________________________________________________________________________
  349.   |                                                                         |
  350.   |         The following information must accompany the payment:           |
  351.   |         =====================================================           |
  352.   |                                                                         |
  353.   |     Name       _________________________________________________________|
  354.   |                                                                         |
  355.   |     Address    _________________________________________________________|
  356.   |                                                                         |
  357.   |     Postcode   _________________________________________________________|
  358.   |                                                                         |
  359.   |     City       _________________________________________________________|
  360.   |                                                                         |
  361.   |     Country    _________________________________________________________|
  362.   |                                                                         |
  363.   |     Date       ___________________________   Phone: ____________________|
  364.   |                                                                         |
  365.   |     Has paid   ___________ for VBIT license (see PRICE above):          |
  366.   |          _                                                              |
  367.   |         [_] Check / money order enclosed                                |
  368.   |         [_] BankGiro: 5353.05.22667 (Den Norske Bank)                   |
  369.   |         [_] PostGiro: 0826.06.97588 (Post cheque)                       |
  370.   |                                                                         |
  371.   |         [_] Visa        [_] American Express     [_] EuroCard           |
  372.   |         [_] MasterCard  [_] Diners International                        |
  373.   |                                                                         |
  374.   |         Creditcard number  :_________________________________________   |
  375.   |                                                                         |
  376.   |         Expiration date    :_________________________________________   |
  377.   |                                                                         |
  378.   |         Signature          :_________________________________________   |
  379.   |                                                                         |
  380.   |     Want to receive the license code [_] via post.                      |
  381.   |                                      [_] via Fax:    ___________________|
  382.   |     VBIT version:      ________                                         |
  383.   |                                                                         |
  384.   |     Where did you find VBIT? _______________________________________    |
  385.   |_________________________________________________________________________|
  386.  
  387.   Send above information to Trader's Mascot AS or by fax to
  388.   Fax number +47 7012 4090
  389.  
  390.   If you pay directly to the bank account or international Post services,
  391.   you may prefer to send the above information as E-mail via internet to:
  392.  
  393.   infotech@telepost.no or bjorn@traders.no
  394.  
  395.   We will send the code to you as soon as we have confirmed the payment.
  396.  
  397.   You may also call the Trader's Mascot BBS, running Excalibur BBS:
  398.   +47/7012-9014 or +47/7012-5102.
  399.  
  400. ____________________________________________________________________________
  401.  
  402. > FEEDBACK
  403.  
  404.   If you have comments, error reports, suggestions for improvements and
  405.   extensions, please write to:
  406.  
  407.   InfoTech AS                                      infotech@telepost.no
  408.   Strandgaten 207                                  ^^^^^^^^^^^^^^^^^^^^
  409.   N-5004 Bergen, Norway
  410.  
  411. or
  412.  
  413.   Trader's Mascot AS                                  bjorn@traders.no
  414.   Postboks 3098 Sentrum                               ^^^^^^^^^^^^^^^^
  415.   N-6001 AALESUND, Norway
  416. _____________________________________________________________________________
  417. _______________________________END_OF_README_________________________________
  418.